home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1992 June: ROMin Holiday / ADC Developer CD (1992-06) (''ROMin Holiday'')_iso / Developer Connection - 06-1992.iso / Development Platforms / Apple II / Essentials / Technical.Notes / IIGS / TN.IIGS.047 < prev    next >
Encoding:
Text File  |  1988-12-20  |  2.3 KB  |  51 lines  |  [TEXT/pdos]
  1. Apple II
  2. Technical Notes
  3. _____________________________________________________________________________
  4.                                                   Developer Technical Support
  5.  
  6.  
  7. Apple IIGS
  8. #47:    What SetDataSize Does
  9.  
  10. Written by:    Keith Rollin                                     November 1988
  11.  
  12. This Technical Note clears up any ambiguity in the description of the 
  13. SetDataSize call.
  14. _____________________________________________________________________________
  15.  
  16. The Apple IIGS supports windows that contain scroll bars in their frames.  
  17. These scroll bars are handled by TaskMaster and differ from Macintosh scroll 
  18. bars in that the size of the "thumb" or "elevator" is used to indicate the 
  19. size of the visible area of the document in relation to the total size of the 
  20. document (the "data size").  Initially, the visible size and the data size are 
  21. defined by the parameter list passed to NewWindow; however, either of these 
  22. can be changed by SizeWindow and SetDataSize, respectively.
  23.  
  24. SetDataSize is used to not only change the range of scrolling allowed, but 
  25. also to redraw the size of the thumb to reflect the fact that the data size 
  26. has changed with respect to the visible area.  However, page 25-97 of the 
  27. Apple IIGS Toolbox Reference contains the following description of 
  28. SetDataSize:
  29.  
  30.      "Sets the height and width of the data area of a specified window.  
  31.      Setting these values will not change the scroll bars or generate 
  32.      update events."
  33.  
  34. When the manual states that SetDataSize "will not change the scroll bars," it 
  35. is referring to the location, or value, of the thumb.  Assume a situation 
  36. where you have a word processor that scrolls the page using TaskMaster scroll 
  37. bars.  If you delete a range of text, you would also shorten the entire size 
  38. of the document.  Calling SetDataSize to reflect that would indeed change the 
  39. size of the thumb, but it would not change its location.  If you were already 
  40. scrolled to the bottom of the document when you called SetDataSize, the thumb 
  41. would become larger (to reflect the fact the the total data size became 
  42. smaller with respect to the visible data size) and overwrite the down arrow of 
  43. the scroll bar.  To prevent this situation from occurring, you should also 
  44. change the origin of the window with SetContentOrigin before calling 
  45. SetDataSize.
  46.  
  47.  
  48. Further Reference
  49. o    Apple IIGS Toolbox Reference, Volume 2
  50.  
  51.